home *** CD-ROM | disk | FTP | other *** search
/ The Fatted Calf / The Fatted Calf.iso / Unix / Graphics / pscal / pscal.man < prev    next >
Encoding:
Text File  |  1994-05-17  |  3.1 KB  |  78 lines
  1.  
  2.  
  3. PSCAL(1)            UNIX Programmer's Manual             PSCAL(1)
  4.  
  5.  
  6. NAME
  7.      pscal - generate PostScript calendars
  8.  
  9. SYNOPSIS
  10.      pscal [ -e | -f<cal> ] [ -m <month> [ -y <year> ]] [ -r ] [
  11.      -s ] [ -t <titlefont name> ] [ -d <dayfont name> ]
  12.  
  13. DESCRIPTION
  14.      Pscal generates PostScript to produce landscape or portrait
  15.      calendars for any month and year.  The arguments <month> and
  16.      <year>, if provided, should be numeric.  The month should be
  17.      in the range 1 - 12, and year should be specified as 1 or 2
  18.      digits or as the full 4 digit year.  The defaults for month
  19.      and year are the current month and year.  If month is pro-
  20.      vided, but zero, the entire year is printed.
  21.  
  22.      If a file named calendar resides in the caller's home direc-
  23.      tory, it will be searched for lines with leading dates
  24.      matching the requested month and year (current by default).
  25.      Any text following the date will be printed on the calendar
  26.      under the appropriate day of the month.  Dates in the calen-
  27.      dar file may consist of a numeric or alpha month (at least
  28.      the first 3 characters for month names) followed by a
  29.      numeric day and optionally followed by a year.  Any non-
  30.      numeric character may separate numeric dates.  Holidays may
  31.      be flagged by following the date immediately with '*'; this
  32.      will cause the date to be printed in gray.  Lines in the
  33.      calendar file consisting of "year xxxx" (where xxxx is a
  34.      numeric year) can be used to set the year for following
  35.      entries.  This assumes that the following entries do not
  36.      contain a year; any date entries containing year information
  37.      will set the remembered year to that year.
  38.  
  39.      Pscal has many options:
  40.  
  41.      -e   Print an empty calendar.  Do not print entries from a
  42.           calendar file.
  43.  
  44.      -f<cal>
  45.           Directs pscal to use the file name <cal> as the input
  46.           file in place of the default calendar file in the call-
  47.           ers home directory.
  48.  
  49.      -r   This will cause the output to come out in portrait mode
  50.           instead of landscape.
  51.  
  52.      -s   This will cause Saturdays to be printed in black
  53.           instead of gray.
  54.  
  55.      -t<titlefontname>
  56.           This option can be used to change the font the title is
  57.           printed in. (ie. pscal -t Times-Roman).
  58.  
  59.      -d<dayfontname>
  60.           This option is the same as -t except that the font used
  61.           to print the day numbers is changed.
  62.  
  63. SEE ALSO
  64.      cal(1)
  65.  
  66. CAVEATS
  67.      The original PostScript code to generate the calendars was
  68.      written by Patrick Wood (Copywrite (c) 1987 by Patrick Wood
  69.      of Pipeline Associates, Inc.), and authorized for modifica-
  70.      tion and redistribution.  The calendar file inclusion code
  71.      was originally written in "bs(1)" by Bill Vogel of AT&T.
  72.      Patrick's original PostScript was modified and enhanced
  73.      several times by others whos names have regrettably been
  74.      lost.  Ken Keirnan of Pacific Bell assembled the original
  75.      "C" version upon which this is based; additional modifica-
  76.      tions and enhancements were the work of Joseph P.  Larson,
  77.      Ed Hand, and Andrew W. Rogers.
  78.